

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Set up Subversion [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Version Control,Version Control Subversion, Setting Up,Subversion,Subversion Setting Up,Subversion Repository URLs,Subversion Executables,Subversion Documentation,Subversion Caching Client Credentials">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Set up Subversion</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="subversioncontrol.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="creatinganewrepositorysub_.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Obtain and Install Subversion</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">Enterprise Architect relies on exclusive file locking when applying version control to its packages. File locking was not introduced into Subversion until version 1.2. Enterprise Architect does not work with Subversion releases earlier than Subversion 1.2.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">Before Enterprise Architect can be used with Subversion, the appropriate software must be installed by a Subversion administrator. Ask your system administrator to obtain and install the Subversion server and client applications.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Enterprise Architect must use the Subversion command line client to communicate with the Subversion server; it cannot use other clients such as <a href="tortoisesvn.htm">TortoiseSVN</a>.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote" style="color: #ff0000;">Important:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">Before you attempt to use Subversion through </span><span class="f_TiporNoteText">Enterprise Architect</span><span class="f_TiporNoteText">, you must first verify that you can use the Subversion command line client to access and operate on files within the working copy folder that </span><span class="f_TiporNoteText">Enterprise Architect</span><span class="f_TiporNoteText"> will use. Your environment must be set up such that you can perform these operations without ever being prompted for user ID or password. For further information, please see the topic </span><span class="f_TiporNoteText" style="font-style: italic;">Caching Client Credentials</span><span class="f_TiporNoteText"> </span><span class="f_TiporNoteText">in the official Subversion documentation.</span></p>
<p class="p_TiporNoteText"><span class="f_TiporNoteText">The official Subversion documentation can be found at: <a href="http://svnbook.red-bean.com/en/1.4/index.html" target="_blank" class="weblink">http://svnbook.red-bean.com/en/1.4/index.html</a>, while executable files for Subversion can be obtained from: <a href="http://subversion.tigris.org/project_packages.html#binary-packages" target="_blank" class="weblink">http://subversion.tigris.org/project_packages.html#binary-packages</a>.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">You require the Windows executables for your client machines running Enterprise Architect in the windows environment. If you plan to run your Subversion server on a non-windows platform, you must download a binary suitable for that platform as well.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Chapter 6 in the Subversion documentation provides guidance on how to configure the server for different methods of access by the client. Secure connection methods are also covered in this chapter.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Your administrator should set up user IDs and passwords for every person who is to access the repository. Your administrator should then provide all users with the path to the repository, and ensure that they can all connect.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Before users can make use of Subversion, they must <a href="createalocalworkingcopy.htm">create local working copies</a> from the repository by checking-out a <a href="creatinganewrepositorysub_.htm">repository sub-tree</a>.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Steps for setting up a repository and creating a local working copy can be found at:</span><span style="font-size: 10pt; color: #0000ff; text-decoration: underline;"><a href="http://svnbook.red-bean.com/en/1.4/svn.basic.in-action.html#svn.advanced.reposurls" target="_blank" class="weblink">http://svnbook.red-bean.com/en/1.4/svn.basic.in-action.html#svn.advanced.reposurls</a></span><span class="f_BodyText">.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">Sparx Systems recommend that each new Enterprise Architect model being added to version control with Subversion should have a separate repository sub-tree created for it, and users should create a new local working copy from the sub-tree to be used with that model.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Repository URLs</span></p>
<p class="p_BodyText"><span class="f_BodyText">Subversion repositories can be accessed using many different methods, on local disk or through various network protocols. A repository location, however, is always a URL. The table below describes how different URL schemas map to the available access methods.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="88" bgcolor="#e3e6ed" style="width:88px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Schema</span></p>
</td>
<td valign="top" width="392" bgcolor="#e3e6ed" style="width:392px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Access Method</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="88" style="width:88px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">file:///</span></p>
</td>
<td valign="top" width="392" style="width:392px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Direct repository access (on local disk).</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="88" style="width:88px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">http://</span></p>
</td>
<td valign="top" width="392" style="width:392px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Access via WebDAV protocol to a Subversion-aware Apache server.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="88" style="width:88px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">https://</span></p>
</td>
<td valign="top" width="392" style="width:392px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Same as http://, but with SSL encryption.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="88" style="width:88px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">svn://</span></p>
</td>
<td valign="top" width="392" style="width:392px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Access via custom protocol to an svnserve server.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="88" style="width:88px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">svn+ssh://</span></p>
</td>
<td valign="top" width="392" style="width:392px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Same as svn://, but through an SSH tunnel.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">For more information on how Subversion parses URLs, see </span><span style="font-size: 10pt; color: #0000ff; text-decoration: underline;"><a href="http://svnbook.red-bean.com/en/1.4/svn.basic.in-action.html#svn.advanced.reposurls" target="_blank" class="weblink">http://svnbook.red-bean.com/en/1.4/svn.basic.in-action.html#svn.advanced.reposurls</a></span><span class="f_BodyText">.</span></p>
<p class="p_SeeAlso"><span class="f_SeeAlso">See Also</span></p>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1"><a href="configureversioncontrolwith.htm">Configure Version Control with Subversion</a></span></li>
</ul>




            </div>
          </div>
        </div>



</div>


</body>
</html>
